Returns a handle to the next GDevice structure in the device list.

GDHandle GetNextDevice (
    GDHandle curDevice
);

Parameter descriptions

curDevice

A handle to the GDevice structure at which you want the search to begin.

function result

A handle to the next device. If there are no more GDevice structures in the list, NULL.

DISCUSSION

After using any of the functions GetDeviceList, GetGDevice, GetMainDevice, or GetMaxDevice to obtain a handle to a GDevice structure, use the GetNextDevice function to obtain a handle to the next GDevice structure in the list.

SPECIAL CONSIDERATIONS

The GetNextDevice function may move or purge memory blocks in the application heap; do not call this function at interrupt time.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)